Skip to content

Reorganize skills into 15 category folders#91

Open
exiao wants to merge 2 commits intomainfrom
refactor/categorize-skills
Open

Reorganize skills into 15 category folders#91
exiao wants to merge 2 commits intomainfrom
refactor/categorize-skills

Conversation

@exiao
Copy link
Copy Markdown
Owner

@exiao exiao commented Apr 15, 2026

Skills Repo Reorganization

Moves 110+ flat skills into organized category folders. No functionality changes — Hermes uses rglob("SKILL.md") so nesting doesn't affect discovery.

Categories (15)

Category Skills
app-store app-store-connect, app-store-screenshots, aso, ios-simulator
advertising apple-search-ads, google-ads, google-ads-scripts, meta-ads, meta-ads-creative, paid-ads, dataforseo, seo-research
analytics appfigures, last30days, content-performance-report
marketing brand-identity, cold-email, competitive-analysis, content-strategy, content-pipeline, copywriting, email-sequence, growth, launch-strategy, marketing-psychology, positioning-angles, pricing-strategy, product-marketing-context, referral-program, trend-research, churn-prevention
writing article-writer, editor-in-chief, outline-generator, writer, substack-draft, evaluate-content
creative character-creation, video-production, video-editor, video-script, stock-footage, klingai, seedance, remotion-best-practices, screen-recording, nano-banana-pro
visual-design design-review, userinterface-wiki, excalidraw-mcp, impeccable + existing sub-skills
finance alpaca, copilot-money, stock-research, wealth-management, post-insider-trades, post-investinglog-trades, earnings-card-pipeline, polymarket, market-daily-briefing
social-media tweet-ideas, typefully, whop-content-rewards, post-bloom-features, notebooklm
devops cloud-migration, deploy-bloom, railway, render-cli, verify-deploy, phoenix-cli, porkbun, stably-cli, stably-sdk-rules, security-audit, documents, document-release
coding superpowers-coding, superpowers-planning, superpowers-reviews, react-doctor, context7, claude-md-management, optimize-prompt, codex, simplify, serena, ralph-mode, babysit-pr
ai-tools agent-browser, grok-search, web-search
bloom bloom-cli, fix-bloom-prs, demo-pr-feature
openclaw openclaw-memory-setup, openclaw-resiliency, hooks, fix-sentry-issues
skills-meta skill-audit, skill-creator, skill-improver, dogfood
research synthetic-userstudies, sahil-office-hours, yc-office-hours, trip-planner, another-perspective

Cross-reference fix

  • email-sequence → churn-prevention path updated (now siblings in marketing/)

Plan

https://skills-reorg.surge.sh

testuser added 2 commits April 14, 2026 23:40
Categories:
- app-store: App Store Connect, ASO, screenshots, simulator
- advertising: Apple Search Ads, Google Ads, Meta Ads, DataForSEO, SEO
- analytics: Appfigures, last30days, content performance
- marketing: brand, copywriting, content strategy, growth, pricing, churn
- writing: articles, editor, outlines, Substack, evaluate-content
- creative: video, screen recording, Kling, Seedance, Remotion, nano-banana-pro
- visual-design: design review, UI wiki, Excalidraw, impeccable, + existing sub-skills
- finance: Alpaca, Copilot Money, stock research, earnings, market briefing
- social-media: tweets, Typefully, Whop, Bloom features, NotebookLM
- devops: cloud migration, deploy, Railway, Render, documents, security
- coding: superpowers, React Doctor, context7, Codex, simplify, serena, ralph, babysit-pr
- ai-tools: agent browser, grok search, web search
- bloom: CLI, PR fixes, demo features
- openclaw: memory setup, resiliency, hooks, Sentry
- skills-meta: audit, creator, improver, dogfood
- research: synthetic user studies, YC office hours, trip planner, another-perspective
@claude
Copy link
Copy Markdown

claude bot commented Apr 15, 2026

Claude finished @exiao's task in 4m 53s —— View job


PR Review: Reorganize skills into category folders

  • Analyze PR scope and changed files
  • Check new files (DESCRIPTION.md, .bundled_manifest)
  • Verify cross-reference fix (email-sequence → churn-prevention)
  • Spot-check skill frontmatter for accuracy
  • Check for hardcoded secrets or personal data
  • Check for broken references in moved files
  • Submit review

Scope mismatch

The PR description says "Moves 110+ flat skills into organized category folders. No functionality changes." but the diff tells a different story:

  • 1,215 renamed files (the actual reorganization)
  • 424 newly added files including 91 new SKILL.md files and a .bundled_manifest
  • ~40 category folders, not the 15 listed in the PR description

Missing from the PR description: apple/, autonomous-ai-agents/, data-science/, diagramming/, domain/, email/, feeds/, gaming/, gifs/, github/, hermes/, hermes-patches/, inference-sh/, leisure/, mcp/, media/, mlops/ (with 6 subcategories), note-taking/, openclaw-docker-debug/, productivity/, project-context/, red-teaming/, smart-home/, software-development/, web-scraping/

This should be documented accurately so reviewers know what they're approving.


Issues found

1. Broken cross-references (2 missing skills)

  • content-management — referenced by social-media/typefully/SKILL.md (line 468) and visual-design/slideshow-creator/SKILL.md (line 3), but this skill doesn't exist anywhere in the repo.
  • healthcheck — referenced by devops/security-audit/SKILL.md (lines 7+), but this skill doesn't exist anywhere in the repo.

Fix broken references →

2. README.md files inside skill directories

Per repo conventions (CLAUDE.md): "No README.md, CHANGELOG.md, or human-facing docs inside skill directories." These new files violate that:

  • creative/ascii-video/README.md
  • creative/manim-video/README.md
  • creative/p5js/README.md
  • mlops/training/grpo-rl-training/README.md
  • research/research-paper-writing/templates/README.md (+ 3 sub-template READMEs)

3. DESCRIPTION.md format inconsistencies

Two DESCRIPTION.md files don't follow the YAML-frontmatter-only pattern used by the other 36:

  • inference-sh/DESCRIPTION.md — No YAML frontmatter at all; uses plain markdown instead. Should have ---\ndescription: ...\n--- format.
  • domain/DESCRIPTION.md — Has extra fields (name, license) and a full markdown body below the frontmatter. DESCRIPTION.md files elsewhere are frontmatter-only.

4. .bundled_manifest added at repo root

This file maps skill names to content hashes. Is this generated/build output? If so, it probably shouldn't be committed, or it should be documented. If intentional, the PR description should mention it.

5. Cross-reference fix verified ✅

The email-sequencechurn-prevention path update is correct. Both skills are now siblings in marketing/ and reference each other properly.

6. No hardcoded secrets found ✅

All credentials use environment variables or placeholder values (YOUR_*, sk-..., $ENV_VAR).


Summary

The reorganization of existing skills (renames) looks clean. However, the PR bundles in ~91 new skills and ~40 categories without documenting them, has 2 broken cross-references to nonexistent skills, adds README.md files that violate repo conventions, and has inconsistent DESCRIPTION.md formatting. The scope should be accurately described and the issues above addressed before merge.

<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Generative Art Viewer</title>
<script src="https://cdnjs.cloudflare.com/ajax/libs/p5.js/1.11.3/p5.min.js"></script>
Copy link
Copy Markdown

@claude claude bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review: Request Changes

Scope mismatch: PR description lists 15 categories and "no functionality changes," but the diff adds ~91 new SKILL.md files, ~40 categories (vs. 15 documented), and a .bundled_manifest. The description should accurately reflect what's being merged.

Issues to fix:

  1. Broken cross-references: content-management skill referenced by social-media/typefully/SKILL.md and visual-design/slideshow-creator/SKILL.md doesn't exist. healthcheck skill referenced by devops/security-audit/SKILL.md doesn't exist.
  2. README.md in skill dirs: creative/ascii-video/, creative/manim-video/, creative/p5js/, mlops/training/grpo-rl-training/, and research/research-paper-writing/templates/ contain README.md files, violating repo conventions.
  3. Inconsistent DESCRIPTION.md: inference-sh/DESCRIPTION.md lacks YAML frontmatter; domain/DESCRIPTION.md has extra fields and a markdown body unlike all other DESCRIPTION.md files.

No hardcoded secrets found. The email-sequence → churn-prevention cross-reference fix is correct.

See full review in PR comment.

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f60eb68474

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@@ -109,7 +109,7 @@ Reference for all lifecycle message types. Covers push notifications (available
**Trigger:** RevenueCat `BILLING_ISSUE` event
**Goal:** Recover revenue, retain subscriber

See [churn-prevention skill](../../churn-prevention/SKILL.md) for the full billing issue sequence.
See [churn-prevention skill](../churn-prevention/SKILL.md) for the full billing issue sequence.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Fix churn-prevention reference path

The updated link now points to ../churn-prevention/SKILL.md, but from marketing/email-sequence/references/ that resolves to marketing/email-sequence/churn-prevention/SKILL.md, which does not exist. This breaks the documented handoff for failed-payment recovery workflows; the sibling skill under marketing/ requires going up two levels (../../churn-prevention/SKILL.md).

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants